home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,101 to 4,200 / aol-file-protocol-4400-4101-to-4200.zip / AOLDLs / ADV - Articles & Misc / 8_16 Writer's Guidelines (v1.2) / GLS.8.16.shk / GLS.8.16.TXT
Text File  |  1990-02-03  |  10KB  |  244 lines
  1. ====    -------------------
  2. 8/16    Writer's Guidelines
  3. ====    -------------------
  4.  
  5. version 1.2, 2/2/90, ECM
  6.  
  7.  
  8. === I. Just what is 8/16, anyhow? ===
  9.  
  10. 8/16 is a new Apple II technical journal. For the past two years Ariel
  11. Publishing has produced and distributed several smaller language-specific
  12. newsletters (Znews, Reboot, and The Sourceror's Apprentice), but we've now
  13. combined them into one larger journal. Our intention is to fill the aching
  14. need created by the death of Call-APPLE.
  15.  
  16. We publish approximately 40-50 pages of articles and source code each month
  17. in several of the languages popular on the Apple IIe, IIc, IIc+ and IIgs.
  18.  
  19. Since so many of our readers intend to develop commercial or shareware
  20. products, we believe they are best served by granting them free use of the
  21. routines we have published (in their compiled/assembled form). Furthermore,
  22. we allow our authors to preserve their copyright of the original source code,
  23. meaning they are free to sell their source code elsewhere, too. We do reserve
  24. the right to use the source you've submitted in our disk and compilation
  25. packages ("The Best Of 1990", etc.).
  26.  
  27.  
  28. === II. What kind of stuff are we looking for? ===
  29.  
  30. Tips, techniques, and short cuts. Improvements on code we've already
  31. published. Subtleties of using the IIgs toolbox. Almost anything, but
  32. especially subjects easily misunderstood, poorly documented, or otherwise
  33. obtuse.
  34.  
  35. We like articles in the following languages: TML Basic, TML Pascal, ORCA/C,
  36. ORCA/Pascal, Merlin 8, 16 and 16+, ORCA/M (8 bit & 16 bit), APW, Micol
  37. Advanced BASIC GS, ZBASIC, and (of course!) Applesoft. We will consider
  38. articles featuring other environments, but please send us a query letter or
  39. give us a call.
  40.  
  41. If you've got yourself a great idea, for the benefit of all concerned, drop
  42. the appropriate editor a query letter (there's a list of names and addresses
  43. at the end of this document). It could be a grand waste of your time if you
  44. submit a lengthy article and we already have one on the same subject waiting
  45. in the wings. We can't stress this enough. PLEASE PLEASE drop us a note
  46. before you start anything that takes any amount of your valuable time.
  47.  
  48. We are definitely NOT interested in articles on beginning programming in
  49. Applesoft (though we ARE interested in beginner articles in "C", because it's
  50. still a relatively new language to Apple II programmers). Although all
  51. articles should explain your code's workings in great detail, you may assume
  52. that readers understand the meaning of "LDA (PTR),Y", "WriteLn ("Hello,
  53. World")", and the like.
  54.  
  55. We are also avoiding DOS 3.3. Our apologies (and condolences) to the
  56. die-hards.
  57.  
  58. Further, we are NOT interested in book reviews, editorials, and so on. The
  59. intention is to have good source code accompany almost every article.
  60.  
  61. If you are searching for ideas, stop and consider the programming projects
  62. you've already undertaken. The chances are high that you learned something
  63. "tricky" from that last piece of software. Expound on the tricky part! Others
  64. will be able to benefit from your experience.
  65.  
  66. ABOVE ALL, and most importantly, make certain your information is accurate.
  67. No matter how wonderful an article or program segment is, it will probably be
  68. ditched if there are any inaccuracies in it. Check and document your sources,
  69. please.
  70.  
  71.  
  72. === III. What stylistic requirements do you have and how long can it be? ===
  73.  
  74. Leave very little to the imagination. EXPLAIN, EXPLAIN, EXPLAIN. I would much
  75. rather edit out too much detail than try to insert more. As much as possible,
  76. try to be somewhat "light".
  77.  
  78. As for the mechanics of writing the article, put no tabs on the paragraphs in
  79. the article, and stuff a blank line between each paragraph.
  80.  
  81. What about length? A great sage once said, "An article should be like a
  82. skirt: long enough to accurately cover the subject at hand but short enough
  83. to be interesting." We will be running your article in 10 point Bookman with
  84. 11 point leading (using PageMaker on the Macintosh--our dedicated typesetting
  85. machine. Our GS's are too important to tie up). If you've got a Mac, you can
  86. probably figure out exactly how long your article will end up in the
  87. magazine. A general rule of thumb: two pages of text in AppleWorks translates
  88. to about one page in the magazine.
  89.  
  90. Also, we publish a monthly disk to go with the magazine. If you've got code
  91. that absolutely _cannot_ be shortened and is too long for the magazine, we
  92. can always publish it on the disk. See the "What about the Disk?" section
  93. below.
  94.  
  95. When submitting IIgs source code keep in mind that you can take advantage of
  96. what the compiler comes with. For example, Merlin comes with a generic
  97. startup/shutdown routine (and we've run them in The Sourceror's Apprentice,
  98. before), so that code won't be printed with your article. In summation, the
  99. source code you incorporate into your article, only include the "core" of a
  100. routine.
  101.  
  102. Along the same lines, unless it's the main thrust of your article, don't
  103. worry about extensive error trapping--that can be left as an 'exercise for
  104. the reader.'
  105.  
  106.  
  107. === IV. What should I send you, and how? ===
  108.  
  109. You may submit your article in two different manners: electronic mail or
  110. snail (US) mail. We here at Ariel much prefer electronic mail because it's
  111. much faster, easier to send more data, and, of course, it's the wave of the
  112. future.
  113.  
  114. If you're going to send us an article via email, we need the following:
  115.  
  116.   *  Article in original format (AWP, or even a Macintosh WP file is okay).
  117.  
  118.   *  Article in straight text form, with no formatting codes, and carriage
  119. returns at the end of paragraphs only.
  120.  
  121.   *  Object code, if applicable (SYS, EXE, S16, whatever).
  122.  
  123.   *  Source code in original format (SRC, probably, or the Merlin .S file).
  124.  
  125.   *  Source code in TXT format, with TABs expanded (for Merlin, use the
  126. Printfiler utility or the "LST FILE,filename" command). (Note: by source
  127. code, we mean the linker command file, macro file, and anything else we
  128. might need to do a complete build on your program. The acid test to be
  129. sure you've included all files is for you to try building it yourself,
  130. separating all the files into their own directory and
  131. compiling/assembling it from there.)
  132.  
  133.   *  And any other pertinent files, such as a sample data set or graphic.
  134.  
  135. When submitting via electronic mail, please use the popular ShrinkIt utility
  136. to put your submission together into a single file. See the end of this
  137. document for electronic mail addresses.
  138.  
  139. If you're going to submit something via snail mail, we need the following:
  140.  
  141.   *  Everything above on a 3.5" or 5.25" disk, plus...
  142.  
  143.   *  A printout of the source code
  144.  
  145.   *  A printout of the article
  146.  
  147.  
  148. Some thoughts on article format...
  149.  
  150. There's two ways to write your article: either with the source code
  151. incorporated inside the article, where you explain each little segment of
  152. code as you go through the entire listing, or with the source code as a
  153. completely separate listing. Either way is fine with us, really, although we
  154. always prefer your source code to be NARROW--less than 50 characters across,
  155. if possible, so we can squeeze two columns of code onto the page. When
  156. working with assembly language, one way to accomplish this is to comment each
  157. section of code (in the source listing) _above_ the opcodes, like this:
  158.  
  159.      * The following code does this and this.
  160.           code
  161.           code
  162.           code
  163.  
  164. Other languages (BASIC, C, Pascal) don't suffer as much when the lines wrap
  165. around. However, please watch your tabbing in C or Pascal code: in larger
  166. routines, you can end up with 40 blank spaces on a line before a statement
  167. starts.
  168.  
  169. When writing your article, please _don't_ refer to line numbers--refer to
  170. labels instead. Don't be afraid to add more labels than necessary to your
  171. code, if it helps make it more readable and easier to reference in the
  172. article.
  173.  
  174.      
  175. === V. What about the disk? ===
  176.  
  177. We publish a monthly companion disk to go with 8/16. Included on this disk
  178. are the entire contents of the month's magazine, approximately 200K - 300K of
  179. additional 8 bit source code, and about the same amount of 16 bit source
  180. code. If you have an EXTREMELY long article or program, we'd love to run it
  181. on the disk. Please get in touch with us. Similarly, we may reject your
  182. article for the magazine but may be interested in including it on the disk.
  183. Also, if you're not in the mood to write an article, we can take
  184. (well-commented) source code alone for use on the disk (we pay very little or
  185. not at all for submissions without articles, however).
  186.  
  187.  
  188. === VI. What do I get if you print my article? ===
  189.  
  190. You'll get our gratitude, of course, and a check for $100-$200 within a month
  191. or so of publication. As our subscriptions increase, so will our
  192. renumeration. And you'll get your name in print, as well as the fame and
  193. glory that goes with being one of the hottest programmers around.
  194.  
  195.  
  196. -----------------------------------------------------------------------------
  197.  
  198. Thank you for your interest in 8/16! If you have any further questions,
  199. please don't hesitate to write or call. Additionally, if you see anything
  200. we've missed in this guide, let us know and we'll fix it right up.
  201.  
  202.  
  203. Subscription information:
  204.  
  205.         one year subscription, paper (12 issues): $29.95
  206.           one year subscription, disk (12 disks): $69.95
  207.                         1/2 year, disk (6 disks): $39.95
  208.                         1/4 year, disk (3 disks): $21.00
  209.            one year subscription, paper and disk: $99.90
  210.  
  211. We accept Visa, MasterCard, check or money order, and can take email orders
  212. (send them to R.W.LAMBERT on GEnie, or D1550 on AppleLink- industrial
  213. edition).
  214.  
  215. -----------------------------------------------------------------------------
  216.  
  217. Publisher and Editor-In-Chief:
  218.  
  219.                        Ross W. Lambert
  220.                        P.O. Box 398
  221.                        Pateros, WA  98846
  222.                        (509) 923-2249
  223.  
  224.                        GEnie: R.W.LAMBERT
  225.  
  226.  
  227. Sixteen-bit Editor:    Eric C. Mueller
  228.                        6547 N. Academy Apt. #443
  229.                        Colorado Springs, CO  80918
  230.                        (719) 548-8295
  231.  
  232.                        GEnie: A2PRO.ERIC
  233.  
  234.  
  235. Eight-bit Editor:      Jerry Kindall
  236.                        1139 Maryland
  237.                        Grosse Pointe Park, MI  48230
  238.  
  239.                        GEnie: A2.JERRY
  240.  
  241. -----------------------------------------------------------------------------
  242.  
  243.  
  244.